home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 626-637 / disk_636 / electron / manual.printer < prev    next >
Text File  |  1992-05-06  |  18KB  |  398 lines
  1. #############################################################################
  2. #####                                                                   #####
  3.  #####                      ELECTRON WORLD v3.10                       #####
  4.   #####                   ~~~~~~~~~~~~~~~~~~~~~~~~                    #####
  5.    #####    Written by Stefan Zeiger in 5/6/7/8/12 1991 and 1/1992   #####
  6.   #####   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~  #####
  7.  #####               (c) 1991/1992 by ! WIZARD WORKS !                 #####
  8. #####              ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~                #####
  9. #############################################################################
  10.  
  11.  
  12.  
  13.                   ## +---------- IMPORTANT ----------+ ##
  14.                 #### |           ~~~~~~~~~           | ####
  15.               ###### | THIS PROGRAM IS SHAREWARE !!! | ######
  16.             ######## |  READ "DISCLAIMER" FOR MORE   | ########
  17.           ########## |        INFORMATION !!!        | ##########
  18.             ######## |                               | ########
  19.               ###### |  ELECTRON WORLD 3.10 IS OS2.0 | ######
  20.                 #### |           COMPATIBLE          | ####
  21.                   ## +-------------------------------+ ##
  22.  
  23.  
  24.  
  25.                            --------------------
  26.                            1. TABLE OF CONTENTS
  27.                            --------------------
  28.  
  29.  
  30.            +---------------------------------------------------+
  31.            |   1.  Table of Contents                           |
  32.            |   2.  What is Electron World ?                    |
  33.            |   3.  The rules for the Electron World            |
  34.            |   4.  How to create a field for Electron World    |
  35.            |   5.  The "Options" menu                          |
  36.            |   6.  Processing the fields                       |
  37.            |   7.  Operating the editor                        |
  38.            |   8.  Other features                              |
  39.            |   9.  The demo fields                             |
  40.            |  10.  Known bugs                                  |
  41.            |  11.  Technical information                       |
  42.            |  12.  Disclaimer                                  |
  43.            |  13.  History                                     |
  44.            |  14.  Some additional things                      |
  45.            |  15.  Appendix                                    |
  46.            +---------------------------------------------------+
  47.  
  48.  
  49.  
  50.                         ---------------------------
  51.                         2. WHAT IS ELECTRON WORLD ?
  52.                         ---------------------------
  53.  
  54.  
  55. Electron World is a cellular machine. It uses a ->field of 108 by 58 ->cells,
  56. that is processed through many ->steps.
  57.  
  58.  
  59.  
  60.                     -----------------------------------
  61.                     3. THE RULES FOR THE ELECTRON WORLD
  62.                     -----------------------------------
  63.  
  64.  
  65. Each cell may have one of four states :
  66. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  67.    - Background : black or yellow (Yellow can be used to mark special places
  68.                   or to write something into the field)
  69.    - Wire : blue
  70.    - Electron head : red
  71.    - Electron tail : pink
  72.  
  73. From step to step the cells of the field are changed :
  74. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  75.    - All electron tails become wire cells
  76.    - All electron heads become electron tails
  77.    - Wire cells become electron heads, if there were one or two electron heads
  78.      on the eight cells around them (in the last step)
  79.    - Background cells (black) and markers (yellow) remain unchanged
  80.  
  81.  
  82.  
  83.                 -------------------------------------------
  84.                 4. HOW TO CREATE A FIELD FOR ELECTRON WORLD
  85.                 -------------------------------------------
  86.  
  87.  
  88. A. Creating a field with a text editor
  89. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  90. (If you're using CygnusEd, you should set 'Insert mode' to 'off' and select an
  91. interlaced screen.)
  92. The field MUST(!!!) have a size of 106 x 58. If you use a larger field, you
  93. will get non-sense things, if you use a smaller field, the program will pro-
  94. bably hang. Comments may only be added at the bottom of the field.
  95. The field itself consists of (in this version) five reserved characters :
  96.  
  97.    - '.' for a background cell
  98.    - '=' for a wire cell
  99.    - '+' for an electron tail
  100.    - '*' for an electron head
  101.    - 'x' for a marker. (Remember to use a lower-case 'x')
  102.  
  103. The field must be saved using the standard ASCII format. The name should end
  104. with ".ASC.EW" (That makes it easier to load with Electron World and clearer
  105. to understand what kind of file it is).
  106. Some ready-to-use fields are included in the directory "Fields". You may use
  107. the fields "Empty.ASC.EW" and "Empty2.ASC.EW" (with a yellow bar at the right
  108. side, so that you see, how fast it's loaded) for creating your own fields.
  109.  
  110. B. Creating a field with Electron World
  111. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  112. Since version 0.50 there is a built-in editor in Electron World. See section
  113. "Operating the editor" for a detailed description.
  114. The created fields can be loaded, saved and deleted in the "Disk options" of
  115. the "Project" menu.
  116.  
  117.  
  118.  
  119.                            ---------------------
  120.                            5. THE "OPTIONS" MENU
  121.                            ---------------------
  122.  
  123.  
  124. A. You can select either "Save Icon" or "No Icon" in the "Options" menu. If
  125. ~~ you use "Save Icon" then there will be an Icon created for every field you
  126.    write to disk.
  127.  
  128. B. Electron World knows two file formats: The ASCII field format that is
  129. ~~ used by text editors if you are editing ".ASC.EW" files and the "Compressed"
  130.    format that is only used by Electron World (".EW"). If you don't want to
  131.    use a text editor for your fields, you should select "Save compressed",
  132.    because the "Compressed" format is only halfe as long as the ASCII format
  133.    and it is loaded and saved twice as fast. Your choice in the "Options" menu
  134.    is only needed for saving fields, because the load routine automatically
  135.    checks the file format and loads it properly.
  136.  
  137.  
  138.  
  139.                          ------------------------
  140.                          6. PROCESSING THE FIELDS
  141.                          ------------------------
  142.  
  143.  
  144. A. Start Electron World from the Workbench or the CLI. You don't need "run"
  145. ~~ or "runback", because Electron World is written as LSR (Load-and-stay-
  146.    resident).
  147.    Choose "Disk options" from the "Project" menu, select the file and click on
  148.    "Load".
  149.  
  150.  [ For programmers: There's a little bug in the documentation for SAS/C 5.10.
  151.    If you're linking with "cback.o" to produce LSR programs and you don't want
  152.    to perform any Output to the calling CLI window, you should though set
  153.    "_BackGroundIO" to 1 and close the handle that you get as soon as possible,
  154.    if you want the CLI window to go away. See "User's Guide" of the SAS/C
  155.    manual for futher information. ]
  156.  
  157. B. If you have the right path in the "DEFAULT TOOL" of your field icon, you can
  158. ~~ start Electron World directly by clicking on the field icon. Then the field
  159.    will be loaded automatically.
  160.    If the field is in the same directory as Electron World you may also use the
  161.    workbench's "extended selection". Click once on the field icon, then hold
  162.    down <SHIFT> and double-click on the Electron World icon.
  163.    If you have the ARP library in your libs: directory, you can use the FULL
  164.    "extended selection", which means that you may use all directories. You
  165.    may also click once on the Electron World icon, then hold down shift and
  166.    double-click on the field icon.
  167.  
  168. C. In the CLI you can specify the field directly after the command name. It
  169. ~~ will then be loaded automatically.
  170.  
  171. Select "Project" "Start/Stop" to start or stop processing the field. Select
  172. "Project" "Process 1 step" to process only one step. The step number is
  173. displayed in the information line at the bottom of the screen.
  174.  
  175.  
  176.  
  177.                           -----------------------
  178.                           7. OPERATING THE EDITOR
  179.                           -----------------------
  180.  
  181.  
  182. Since v0.50 Electron World has a built-in editor. It is not very comfortable,
  183. but certainly better than a text editor (And much faster, too, because you
  184. needn't go through that annoying save-edit-load-test-save-... procedure).
  185. The color/status of the field can be selected in the "Edit" menu. You can also
  186. use the key shortcuts (like everywhere in Electron World). Just click on the
  187. cell you wish to change and it will get the new status. You may also drag the
  188. mouse pointer over the field to get a continuous line. Use "Edit" "Clear" to
  189. clear the field.
  190.  
  191. There's also a very special function that can be useful when you're developing
  192. new elements or complete fields. If you've changed your field and want to test
  193. it, you often have to remove some "electron trash" that was left on the field
  194. by a non-functioning element. Since v0.60 Electron World can do this for you.
  195. Just select "Remove electrons" from the "Edit" menu and all electron heads and
  196. tails will get replaced by wire cells. You can also replace markers by back-
  197. ground cells with "Remove markers".
  198.  
  199.  
  200.  
  201.                              -----------------
  202.                              8. OTHER FEATURES
  203.                              -----------------
  204.  
  205.  
  206.                                  ICONIFY :
  207.                                  ~~~~~~~~~
  208. Since version 1.00 there is the item "Iconify" in the "Project" menu. If you
  209. select it, the screen and window of Electron World will be replaced by a small
  210. icon on the workbench screen. This will save about 53 kB of chip memory. If
  211. you want to get back to Electron World, just activate the icon by clicking on
  212. it and then press the right mouse button. The screen and window will be opened
  213. again and field will get redrawn. This can take (according to the field) up to
  214. 8 seconds. If there is not enough chip memory available to re-open, Electron
  215. World will quit. So be careful, if you don't want to loose your field !!!
  216.  
  217.  
  218.  
  219.                             ------------------
  220.                             9. THE DEMO FIELDS
  221.                             ------------------
  222.  
  223.  
  224.    +-------------------------------------------------------------------+
  225.    |   Test.EW            This is a simple demo field. I am using it   |
  226.    |                      for my performance tests. ( This version     |
  227.    |                      should be able to process this field for     |
  228.    |                      50 steps in about 11.35 seconds. )           |
  229.    |   Diode_Test.EW      This example shows how to draw and use the   |
  230.    |                      diode described in [1].                      |
  231.    |   Empty1.EW          Just an empty field.                         |
  232.    |   Empty2.EW          An empty field with a yellow marker line at  |
  233.    |                      the right side, so that you can see how      |
  234.    |                      fast it's loaded.                            |
  235.    |   Empty1.ASC.EW      Like "Empty1.EW", but in ASCII format.       |
  236.    |   Empty2.ASC.EW      Like "Empty2.EW", but in ASCII format.       |
  237.    |   Inverter_13.EW     This is an inverter like the one described   |
  238.    |                      in [1], that uses a tact rate of 13 steps.   |
  239.    |   Labyrinth1.EW      | These fields just produce some nice        |
  240.    |   Labyrinth2.EW      | pictures. Compute them and have fun !      |
  241.    |   Ornament.EW        This field is completely built with wire     |
  242.    |                      cells, so the electron in the middle can do  |
  243.    |                      what ever it wants to to. There's one fact,  |
  244.    |                      that makes this field interesting : Some-    |
  245.    |                      times the outline of the square is copletely |
  246.    |                      closed. This happens all 2k-1 [k¢Z] steps.   |
  247.    |   Memory.EW          A memory for one bit (WOW!!!) with a tact    |
  248.    |                      rate of 13. See description in [1].          |
  249.    |   Or_Test.EW         A testing picture for the "or" element       |
  250.    |                      described in [1].                            |
  251.    |   Title.EW           This one is just for fun.                    |
  252.    +-------------------------------------------------------------------+
  253.  
  254.  
  255.  
  256.                               --------------
  257.                               10. KNOWN BUGS
  258.                               --------------
  259.  
  260.  
  261.               "It's not a bug, it's an undocumented feature."
  262.               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  263. I haven't found any bugs (yet). If you do so, please let me know it. Write to
  264. the address at the end of this manual.
  265.  
  266.  
  267.  
  268.                          -------------------------
  269.                          11. TECHNICAL INFORMATION
  270.                          -------------------------
  271.  
  272.  
  273. Electron World was written using SAS/C 5.10. The file requesters is my own,
  274. enhanced version of Anders Bjerin's "File Window". Thanks, Anders !
  275.  
  276.  
  277.  
  278.                               --------------
  279.                               12. DISCLAIMER
  280.                               --------------
  281.  
  282.  
  283. Electron World v3.10 was written by Stefan Zeiger in 1991 and '92. It is copy-
  284. righted (c) 1991/'92 by ! WIZARD WORKS ! . This program may be distributed for
  285. non-commercial only. All files must be kept together and must remain unchanged.
  286. You may only charge a distribution fee less or equal to the fee that Fred Fish
  287. wants for his AmigaLibDisks.
  288. This program is distributed "as-is". ! WIZARD WORKS ! doesn't give any warranty
  289. for Electron World.
  290. Electron World is SHAREWARE. You may test it without paying for it. If you
  291. have decided to use this program, you have to pay 10 US$, 20 DM or 6 £ ster-
  292. ling. Send the money to the address at the end of this manual. You will then
  293. become a registered user and get informed about future releases of Electron
  294. World.
  295.  
  296.  
  297.  
  298.                                 -----------
  299.                                 13. HISTORY
  300.                                 -----------
  301.  
  302.  
  303. Here comes the version history of Electron World (beginning with the earliest
  304. version) :
  305.  
  306.       +-------------------------------------------------------------+
  307.       |  0.10a  First working test version.                         |
  308.       |  0.20a  File requester added.                               |
  309.       |  0.30   Icon save facility added.                           |
  310.       |  0.40   New save format "Compressed" added.                 |
  311.       |  0.50   Simple built-in editor added.                       |
  312.       |  0.51   "Remove electrons" facility added.                  |
  313.       |  0.52   Bugs fixed. Optimized version of "File Window".     |
  314.       |  0.60   WB and CLI argument getting facility added.         |
  315.       |  0.65   Bugs fixed.                                         |
  316.       |  1.00   "Iconify" added.                                    |
  317.       |  1.01   Slightly faster.                                    |
  318.       |  1.10   Full "extended selection" support with ARP library. |
  319.       |         First public release.                               |
  320.       |  1.20   Icon creation bug fixed. Fade in/out added. Securi- |
  321.       |         ty checks added.                                    |
  322.       |  2.00   New design. "Remove Markers" added. Second public   |
  323.       |         release.                                            |
  324.       |  2.01   File requester bug fixed. Now using WizardFiler     |
  325.       |         v1.01.                                              |
  326.       |  3.00   Iconify window remembers old position. Now full     |
  327.       |         OS2.0 design. THIS VERSION REQUIRES OS 2.04 !!!     |
  328.       +-------------------------------------------------------------+
  329.  
  330.  
  331.  
  332.                         --------------------------
  333.                         14. SOME ADDITIONAL THINGS
  334.                         --------------------------
  335.  
  336.  
  337. Further information about the cellular automation that can be processed with
  338. "Electron World" is available in [1].
  339.  
  340.             CU,
  341.             Stefan.
  342.                              ____
  343.                             / / /
  344.                     ____   / / /
  345.               Only  \ \ \ / / /|
  346.                      \ \ X / /_|
  347.                       \_X_X_/  |miga makes it possible !!!
  348.  
  349.  
  350.  
  351.                                ------------
  352.                                15. APPENDIX
  353.                                ------------
  354.  
  355.  
  356.                                 A. GLOSSARY
  357.                                 ~~~~~~~~~~~
  358.  
  359. CELL:     A cell is a single part of a ->field that can have one special
  360. ~~~~~     status (see 1.).
  361.  
  362. FIELD:    The field is the whole area that is computed by Electron World. It
  363. ~~~~~~    consists of 106 by 58 ->cells.
  364.  
  365. STEP:     A step in Electron World is a time measure. At each step the ->cells
  366. ~~~~~     of the ->field are computed new.
  367.  
  368.  
  369.                          B. ADDITIONAL INFORMATION
  370.                          ~~~~~~~~~~~~~~~~~~~~~~~~~
  371.  
  372. [1]       "Scientific American" / "Spektrum der Wissenschaft" 3/1990.
  373.  
  374.  
  375.  
  376.  
  377.  
  378. -----------------------------------------------------------------------------
  379.  
  380.    STANDARD MAIL :     ! WIZARD WORKS !
  381.                        Stefan Zeiger
  382.                        Seligenstaedter Weg 24
  383.                        D-W-8756 Kahl
  384.                        West Germany
  385.  
  386.            VOICE :     ++49-(0)6188-2525
  387.  
  388.          MAILBOX :     ++49-(0)69-5975113
  389.                        "The Hitchhiker" (H.T.H.) in Frankfurt
  390.                        300-14400 bps, 8/N/1, 24h online
  391.                        Username : "STEFAN"
  392.  
  393.            EMAIL :     AmNet    : STEFAN;HTH
  394.                        Fido     : STEFAN%HTH.AMN 2:247/12.5
  395.                        Zerberus : STEFAN%HTH@AMNET.ZER
  396.  
  397. -----------------------------------------------------------------------------
  398.